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PARTITIONED DATABASE SYSTEM 

Background 

[0001] Data organization is important in relational database systems that deal with complex queries 
against large volumes of data. Relational database systems allow data to be stored in tables that are 
5 organized as both a set of columns and a set of rows. Standard commands are used to define the 
columns and rows of tables and data is subsequently entered in accordance with the defined structure. 
The defined table structure is logically maintained, but may not correspond to the physical 
organization of the data. For example, the data corresponding to a particular table may be split up 
among a number of physical hardware storage facilities. 

10 [0002] Users of relational database systems require the minimum time possible for execution of 
complex queries against large amounts of data. Different physical types of storage, for example 
random access memory and hard drives, incur different length delays. In addition, writing to memory 
%0 or a hard drive is often slower than reading an equivalent amount of data from memory or a hard drive. 
i& The organization of data corresponding to tables defined in a relational database system may determine 
% the number of writes and reads that need to be performed in order to execute a common query. If the 
bj data is properly organized, performance can be improved by searching a part of the data for queries 
[jj. that can take advantage of that organization. If the data is not organized in a useful way for a query, it 
U will often need to be searched in its entirety to satisfy a query or copied and restructured into a useful 
|f| organization. 

% Summary 

[0003] In general, in one aspect, the invention features a system having storage facilities. Each storage 
facility that include data from database table rows. The database table rows in each storage facility 
that correspond to a specific database table are logically ordered according to a row identifier (row ID). 
The row ID includes a first value that is based on one or more columns of the table. The row ED also 

25 includes a second value that is based on one or more columns of the table, which may be different from 
or the same as those on which the first value is based. The first value of the row ID is predominate in 
determining the order of the rows in the storage facilities. The second value determines the order of 
those rows with identical first values. In a more specific implementation, the row ID also includes a 
third value and that third value determines the order of rows with identical first and second values. 

30 The third value is a uniqueness number that differentiates rows having equal first and second values. 
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[0004] In general, in one aspect, the invention features a method for building a partitioned database 
system. Columns for a database table are defined. A first group of one or more columns is selected. 
A first function based on values in each column of the first group of columns is selected. A second 
group of one or more columns is selected. The second group can be the same as or different from the 
5 first group. A second function based on values in each column of the second group of columns is 
selected. Rows for the table are created. The rows are stored in one or more storage facilities in a 
logical order corresponding to the result of the first function for each row. If more than one row of the 
table has an identical result of the first function, those rows are stored in a logical order corresponding 
to the result of the second function. In a more specific implementation, if a plurality of rows of the 

10 table in a storage facility have identical results of the first and second functions, those rows are stored 
in a logical order corresponding to a third value for each of those rows. In another implementation, the 

C3 method can be implemented on a computer by a program. 

% [0005] In general, in one aspect, the invention features a method for storing a row identification (row 
^ ID) in a data row structure. The data row includes a header and a body. The state of at least one bit in 
the header is set based on whether the row is part of a partitioned or unpartitioned table. A first portion 
w of the row ID is included in the header. If the state of the at least one bit indicates a partitioned table, a 
M second portion of the row ID is included in the body of the data row. A specified second portion is 
jl assumed for a data row when the state of the at least one bit indicates a nonpartitioned table. In a more 
^L: specific implementation, the second portion includes a first value and the first portions includes a 
S© second value and a third value. 

[0006] Other features and advantages will become apparent from the description and claims that 
follow. 

Brief Description of the Drawings 
[0007] Fig. 1 is a block diagram of a node of a database system. 

25 [0008] Fig. 2 is a flow diagram of table distribution process. 

[0009] Fig. 3 illustrates an example partitioned database storage facility. 

[0010] Fig. 4 is a data structure of a row identifier (row ID). 



[001 1] Fig. 5 is a data structure for a data row. 
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[0012] Fig. 6 is a data structure for an index row. 



[0013] Fig. 7 illustrates example storage facilities with partitioned database tables. 

[0014] Fig. 8 is a flow chart of an algorithm for defining and building a partitioned table in a database 
system. 

5 Detailed Description 

[0015] The partitioned table storage technique disclosed herein has particular application, but not 
limited, to large databases that might contain many millions or billions of records managed by a 
database system ("DBS") 100, such as a Teradata Active Data Warehousing System available from 

10 NCR Corporation. FIG. 1 shows a sample architecture for one node 105] of the DBS 100. The DBS 
node 105i includes one or more processing modules 1 10i...n, connected by a network 1 15, that manage 

^0 the storage and retrieval of data in data-storage facilities 120i _ N . Each of the processing modules 

m 1 IOi . n may be one or more physical processors or each may be a virtual processor, with one or more 

U virtual processors running on one or more physical processors. 

ft! [0016] For the case in which one or more virtual processors are running on a single physical processor, 
jj^ the single physical processor swaps between the set of N virtual processors. 

H [0017] For the case in which N virtual processors are running on an M-processor node, the node's 
q operating system schedules the N virtual processors to run on its set of M physical processors. If there 

are 4 virtual processors and 4 physical processors, then typically each virtual processor would run on 
20 its own physical processor. If there are 8 virtual processors and 4 physical processors, the operating 

system would schedule the 8 virtual processors against the 4 physical processors, in which case 

swapping of the virtual processors would occur. 

[0018] Each of the processing modules 110i...n manages a portion of a database that is stored in a 
corresponding one of the data-storage facilities 120i...n. Each of the data-storage facilities 120l. n 
25 includes one or more disk drives. The DBS may include multiple nodes 1052 ..n in addition to the 
illustrated node 105i, connected by extending the network 115. 

[0019] The system stores data in one or more tables in the data-storage facilities 120i_n- The rows 
125i...z of the tables are stored across multiple data-storage facilities 120i...n to ensure that the system 
workload is distributed evenly across the processing modules 1 10i_ N . A parsing engine 130 organizes 
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the storage of data and the distribution of table rows 125i...z among the processing modules 110i...n. 
The parsing engine 130 also coordinates the retrieval of data from the data-storage facilities 120i...n in 
response to queries received from a user at a mainframe 135 or a client computer 140. The DBS 100 
usually receives queries and commands to build tables in a standard format, such as SQL. 

5 [0020] The rows 125i...z are distributed across the data-storage facilities 120i...n by the parsing engine 
130 in accordance with their primary index. The primary index defines the columns of the rows that 
are used for calculating a hash value. The function that produces the hash value from the values in the 
columns specified by the primary index is called the hash function. Some portion, possibly the 
entirety, of the hash value is designated as a hash bucket. The hash buckets are assigned to data- 

10 storage facilities 120l..n and associated processing modules 110i...n by a hash bucket map. The 
characteristics of the columns chosen for the primary index determine how evenly the rows are 

%Q distributed. 

tX [0021] Fig. 2 shows the rows of a table be distributed. The table 200 contains a plurality of rows and 
y l is stored in a plurality of data storage facilities 120j_4 by the parsing engine 130 (not shown). For 
|| example, two columns 210, 220 can be designated as the primary index when the table is created. The 
*. hash function is then applied to the contents of columns 210, 220 for each row. The hash bucket 
Q portion of the resulting hash value is mapped to one of the data storage facilities 120i_4 and the row is 
f fi stored in that facility. For example, if the primary index indicates a column containing a sequential 
hd row number and the hash function is the sum of remainder when the row number is divided by four 
20 and the value one, the first eight rows will be distributed as shown in Fig. 2. 

[0022] Queries involving the values of columns in the primary index can be efficiently executed 
because the processing module 110 n having access to the data storage facility 120 n that contains the 
row can be immediately determined. For example, referring to Figure 2, if values from row 2 are 
desired, the parsing engine 130 can apply the hashing function to determine that only processing 
25 module IIO2 need to be used. As another example, an equality join between two tables that have the 
same primary index columns is very efficient. All of the rows that need to be joined are found in the 
same data storage facility 120 n and no movement of information from rows between the facilities is 
necessary. 



30 



[0023] While the primary index of a table can be chosen for equality joins, for example the order 
number column of an order table, additional design features can make range searches, for example a 
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range of dates from the date column, more efficient. Referring to Fig. 3, a partitioned database storage 
facility 120i is shown. The rows are allocated to the storage facility 120i as discussed above. The 
rows are organized within the storage facility 120i in accordance with a row ID 400. The row ID is 
more specifically shown in Fig. 4. The row ID includes values associated with a partition function as 
5 well as values associated with the hash function and a uniqueness value. The rows stored in the 
storage facility 120i are ordered at a top level by the result of the partition function. As a result, a first 
group of rows 310 has one partition function value. A second group of rows 320 has another partition 
function value. A third group of rows 330 has a third partition value. The groups 310,320,330 are 
ordered by their partition values and are also known as partitions. 

10 [0024] The rows are also ordered with each partition. For example, the first partition 310 contains five 
rows. Those rows are stored within that partition 310 in the order of the hash result for each row. A 

-Jji uniqueness value is also maintained for each row. No two rows with the same partition and hash value 

?t in a table can have the same uniqueness value. The uniqueness values are determined when the rows 

w 

H are added to the table. For example, a sequential number (the next uniqueness number after the highest 

ffi 

one currently being used) or any currently unused number can be used as the uniqueness value. If two 
w rows are in the same partition and have the same hash value, their order is determined by their 
H uniqueness values, which by definition cannot be identical. The uniqueness value does not play a role 

11 in ordering rows that have different partition or hash values. In an alternate implementation, 
'fj, uniqueness values are not assigned to the rows and the order of rows with identical hash values is not 
fe© determined. 

[0025] A partition function can return a number for a row based on the range of values into which that 
row's value in a certain column falls. For example, if an order table in a database has the order number 
column as that table's primary index, the partition function can correspond to the month of the order 
date. In that situation, the rows of the order table would be distributed to storage facilities based on the 

25 result of applying the hash function to the order number. In each storage facility, the rows would be 
ordered based on a monthly range of dates. For example, the first partition 310 could include all rows 
assigned to that storage facility with orders in January 2001. The second partition 320 could include 
all rows for orders in February 2001. Within each partition the rows are in the order of the hash value 
and, where hash values are the same, in order by uniqueness value. Such a partitioned table could be 

30 efficiently searched on ranges by eliminating partitions from the required search. For example, if all 
orders for a certain product during a two-month period are desired, only two partitions on each storage 
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facility would need to be checked for the specified product. The monthly range is just one example of 
a possible partition function. Any type of function can be used. 



[0026] Fig. 4 shows a data structure of a row ID 400. A row ID 400 can be calculated for each row in 
order to allow quick, correct placement of a newly added row. The database system may store the row 
5 ID for each row as a column of that row in addition to the columns defined when the row is created. A 
complete row ID is not required to be stored with each row to implement the invention (if a uniqueness 
value is used in the row ID, that value must be stored with the row). As one example, the processing 
module 110 n could recalculate the partition function and hash function each time a row is accessed to 
determine the row ID for the row. The row ID 400 is Fig. 4 has three parts: the partition value 402, the 
10 hash value 404, and the uniqueness value 406. In one implementation of the invention the partition 
value 402 is one byte long, the hash value 404 is four bytes long, and the uniqueness value is three 
u bytes long. As a result, in that implementation up to 256 partitions can be utilized in storing rows in a 
VO storage facility 120 n . Using the order table example, over twenty years of orders could be kept in one- 
[| month partitions. The hash value 404 in that implementation could be one of 2 possible values. That 
l§ implementation would allow 2 24 uniqueness values 406. This implementation retains the existing 64- 
Ly bit size of the row ID the Teradata implementation. A larger number of possible hash values increases 
* s the number of data storage facilities that can be used to store rows of the database and reduces the 
CI chance that multiple rows will have the same hash value. A larger number of possible uniqueness 
ffl values allow tables with larger numbers of rows with the same partition and hash value to be stored. 

St) [0027] The row ID 400 in another implementation includes a 2-byte partition value 402, a 4-byte hash 
value 404, and a 4-byte uniqueness value 406. In this implementation, more partitions can be used to 
store rows and tables with more rows, because of the increase in uniqueness numbers, can be stored. 
The row ID size is ten bytes overall. Many other row ID's could be implemented that are two- or 
three-level organization of rows in data storage. 

25 [0028] Fig. 5 shows a data structure for a data row. In this implementation, the 10-byte row ID is 
added to a system initially configured for using an 8-byte row ID. Many of the tables in the database 
are not partitioned. In that case, the 2-byte partition value 402 would be zero for all rows. Partitioned 
tables would have partition values other than zero for the rows. One implementation of the invention 
compresses the 2-byte partition value for the nonpartitioned table rows so that a header defined for an 

30 8-byte row ID can remain unchanged, while including a mechanism for determining the row ID for 
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partitioned table rows. The data row 500 includes a header 510 and a body 520. The header 510 
includes at least one bit that is unused in the initial header definition and assigned a reference value. 
For example, the header 510 can include a Flags byte 530 that includes a high-order bit 540 that is 
always initialized as zero prior to the addition of partitioning functionality. The high-order bit 540 is 
5 used to indicate whether the data row 500 is from a partitioned or nonpartitioned table. If the data row 
500 is from a nonpartitioned table, the high-order bit 540 remains zero and the row ID is constructed 
from the 8-bytes of hash and uniqueness values 560 preceded by 2-bytes of zero, the partition value for 
a nonpartitioned table. If the data row 500 is from a partitioned table, the high-order bit 540 is set to 1 
and the 2-byte partition value 550 is the first portion of the body 520. In one implementation, each 
10 row has a row descriptor for identifying the portions of the body 520. The row descriptor is adjusted to 
account for the addition of the 2-byte partition value 550 at the beginning of the body. Thus, a routine 
O can construct the 10-byte row ID for the nonpartitioned data rows by noting the high-order bit 540 
2 state and adding 2-bytes indicating a zero partition value to the hash and uniqueness values 560 
without referencing the row descriptor. 

H [0029] Fig. 6 shows a data structure for an index row 600. In a specific implementation, an index row 
^ 600 consists of an identifying rowid (in the row header) 610, rowids that reference rows in the table 
*f 620, and other data (such as the index value) 630. The identifying rowid 610 of an index row 600 is 
hi handled the same as for the data row 500. As with the data row 500, a descriptor exists for the 
^ contents of the index row 600. This descriptor indicates the size of data values in the row. For a 
fet) nonpartitioned table, the descriptor indicates that the rowids have a size of eight bytes and the partition 
number of zero can be assumed. For a partitioned table, the referenced rowids are extended with the 2- 
byte partition number and the descriptor would indicate they have a size often bytes 

[0030] Adding the 10-byte row ID to a system initially configured for using an 8-byte row ID, can also 
involve modifications to disk-based file system structures to include the partition number. In one 
25 specific implementation, the disk-based file system structures include cylinder index data blocks for 
identifying particular data. The firstrid and lasthash values in the cylinder index data block descriptors 
each need to each be extended by two bytes. For an upgrade, the old cylinder indexes need to be 
converted; however, converting just the cylinder indexes should not take an excessive amount of time 
for an upgrade. 
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[0031] Fig. 7 shows the rows of two tables 710, 720 stored in partitions in two data storage facilities 
120i, 2 . While the rows for each table are partitioned and ordered within the partitions, they are not 
mixed. If the two tables 710, 720 are each partitioned according to the same data and have the same 
primary index, equality joins between the two tables can be conducted within a subset of the storage of 
5 each storage facility. Primary indexes can be used to specify the storage locations for different tables 
within one data storage facility. 

[0032] Different tables in a database system can have different partition functions. For example, the 
first table 710, an order table, can be partitioned by the month of the order date, while the second table 
720, a customer table, is partitioned by the total average yearly purchases of that customer. The 

10 partition function for a table can be chosen to coincide with range calculations commonly performed 
on columns in response to queries. If queries that specify date ranges are common, it can be efficient 

C3 to specify range of dates as the partition function. If queries with item types are common, it can be 
efficient to specify an item type designations as a partition function. Each function represents an 

I jf implementation of the partitioned database system. 

[0033] Fig. 8 shows a flow chart of an algorithm for defining and building a partitioned table in a 
T database system. Initially, a table is created 810. One of the steps in creating a database table is 
^ defining the columns that will contain row data for the table 812. The database system can add 
H columns such as a row ID to those specified. One or more columns are chosen as the primary index 

for the table 814. The primary index is used as the input to the hash function. One or more columns 

HITS? 

fete are also chosen as partitioning columns 816. A function is specified that uses the values of the 
partitioning columns for each row to calculate the partition of that row 818. The partition function 
itself may define the partition columns combining steps 816 and 818. 

[0034] Once a table has been defined, users are allowed to fill the table by creating rows 820. The 
data in the new row is used to determine the hash value and hash bucket by applying the hash function 

25 to the columns of the primary index 822. The data storage facility in which the row is stored is 
determined by the hash bucket in combination with the hash bucket map 824. The partition function is 
applied to the values in the partitioning columns 826. In one implementation, a uniqueness number is 
also assigned to the row 828. The rows for that table in a particular data storage facility are then 
located in order of the partitions 830. Within the partitions, the rows are located in order of the result 

30 of the hash function, the hash value 832. Any rows in a partition that share that hash value are then 
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ordered by the uniqueness value if there is one 834; otherwise, there is no particular order within the 
rows that have the same partition and hash value. 

[0035] In one implementation, the new row is placed in the proper position relative to the already 
ordered previously-input rows. In another implementation, many rows can be added without 
placement in partitions, hash order and uniqueness order, and then sorting according to steps 730, 732, 
and 734 occurs before the table is accessed for queries. Other implementations can be used to store 
rows according to two different functions. 

[0036] The text above described one or more specific implementations of a broader invention. The 
invention also is carried out in a variety of alternative implementations and thus is not limited to those 
described here. For example, while the invention has been described here in terms of a DBMS that 
uses a massively parallel processing (MPP) architecture, other types of database systems, including 
those that use a symmetric multiprocessing (SMP) architecture, are also useful in carrying out the 
invention. Many other implementations are also within the scope of the following claims. 
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